home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / lang / c++-part1 / 3325 < prev    next >
Encoding:
Internet Message Format  |  1996-08-06  |  1.6 KB

  1. Path: lise.physik.tu-berlin.DE!not-for-mail
  2. From: maltez@lise.physik.TU-Berlin.DE (Malte Zoeckler)
  3. Newsgroups: comp.lang.c++
  4. Subject: DOC++, a new documentation system for C++
  5. Date: 23 Jan 96 11:57:11 GMT
  6. Message-ID: <maltez.822398231@lise.physik.TU-Berlin.DE>
  7. Reply-To: doc++@ZIB-Berlin.DE
  8. NNTP-Posting-Host: lise.physik.tu-berlin.de (130.149.40.7)
  9. X-Access: 16 916
  10. X-Newsreader: NN version 6.5.0 #7 (NOV)
  11.  
  12. Hi Net,
  13.  
  14. we would like to announce the first beta release of DOC++, under the
  15. terms and conditions of GPL.
  16.  
  17. DOC++ is a documentation system for C++ programs featuring generation
  18. of:
  19.  
  20.  - HTML documentation
  21.       which allows one to browse through the classes using a standard
  22.       WWW reader such as netscape, 
  23.  
  24.  - LaTeX documentation
  25.       which provides you with a high quality hardcopy of your classes. 
  26.       In addition
  27.       the LaTeX output allows to generate a TeX-documented source code 
  28.       listing.
  29.  
  30. DOC++ follows the approach of maintaining one source code that contains 
  31. both, the C++ program itself along with the documentation in order to 
  32. prevent incompatibilities between the programm and its documentation. 
  33. Unlike other approaches such as WEB, however, sources documented with DOC++ 
  34. are ready to be compiled without need of any preprocessing (like tangle). 
  35. Instead, DOC++ documentation is enclosed in standard C++ comments /* ... */
  36. or // ... <new line>.
  37.  
  38. For more details, examples of the output and the tool itself have a look
  39. at
  40.  
  41.     http://www.ZIB-Berlin.DE/VisPar/doc++/doc++.html.
  42.  
  43. For suggestions and bug reports (along with a minimal example generating
  44. the error) contact
  45.  
  46.     doc++@zib-berlin.de 
  47.  
  48.